Node / meshtastic / Meshtastic-Android / files / feature / firmware / src / commonMain / kotlin / org / meshtastic / feature / firmware / ota / dfu / DfuZipParser.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.feature.firmware.ota.dfu

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787kotlinx.serialization.ExperimentalSerializationApi

Tff7b72import T7ee787kotlinx.serialization.json.Json

Tff7b72import T7ee787kotlinx.serialization.json.JsonDecodingException

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalSerializationApiTff7b72::Te6edf3classTb4b4b4)

Tff7b72private Tff7b72val Te6edf3json Tff7b72= Te6edf3Json Tb4b4b4{

Te6edf3ignoreUnknownKeys Tff7b72= Tff7b72true

Te6edf3exceptionsWithDebugInfo Tff7b72= Tff7b72false

Tb4b4b4}

T8b949e/**

* Parse pre-extracted zip entries into a [DfuZipPackage].

*

* The [entries] map (name → bytes) must come from a Nordic DFU .zip containing `manifest.json` with at least one of:

* `application`, `softdevice_bootloader`, `bootloader`, or `softdevice` entries pointing to the .bin and .dat files.

*

* @throws DfuException.InvalidPackage when the zip contents are invalid.

*/

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffThrowsCountTa5d6ff"Tb4b4b4)

Tff7b72internal Tff7b72fun Td2a8ffparseDfuZipEntriesTb4b4b4(Te6edf3entriesTb4b4b4: Te6edf3MapTff7b72<Tffa657StringTb4b4b4, Te6edf3ByteArrayTff7b72>Tb4b4b4)Tb4b4b4: Te6edf3DfuZipPackage Tb4b4b4{

Tff7b72val Te6edf3manifestBytes Tff7b72=

Te6edf3entriesTff7b72[Ta5d6ff"Ta5d6ffmanifest.jsonTa5d6ff"Tff7b72] Tff7b72?: Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3InvalidPackageTb4b4b4(Ta5d6ff"Ta5d6ffmanifest.json not found in DFU zipTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3manifest Tff7b72=

Te6edf3runCatching Tb4b4b4{ Te6edf3jsonTb4b4b4.Te6edf3decodeFromStringTff7b72<Te6edf3DfuManifestTff7b72>Tb4b4b4(Te6edf3manifestBytesTb4b4b4.Te6edf3decodeToStringTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4}

Tb4b4b4.Te6edf3getOrElse Tb4b4b4{ Te6edf3e Tff7b72-Tff7b72>

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalSerializationApiTff7b72::Te6edf3classTb4b4b4)

Tff7b72val Te6edf3detail Tff7b72= Tb4b4b4(Te6edf3e Tff7b72as? Te6edf3JsonDecodingExceptionTb4b4b4)Tff7b72?.Te6edf3shortMessage Tff7b72?: Te6edf3eTb4b4b4.Te6edf3message

Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3InvalidPackageTb4b4b4(Ta5d6ff"Ta5d6ffFailed to parse manifest.json: Tffd700$Te6edf3detailTa5d6ff"Tb4b4b4)

Tb4b4b4}

T8b949e// Require an application image rather than accepting whatever primaryEntry promotes. A bootloader- or

T8b949e// SoftDevice-only package has imageCount == 1, so it slipped past the warning below and was uploaded with

T8b949e// START_DFU's image type hard-coded to APPLICATION and the sd/bl sizes zeroed — the only thing standing between a

T8b949e// renamed OTAFIX .zip and that path is validateNrf52LocalFirmware's "-ota.zip" suffix check. #5916 left multi-image

T8b949e// *sequencing* out of scope; this only refuses what was never flashable.

Tff7b72val Te6edf3entry Tff7b72=

Te6edf3manifestTb4b4b4.Te6edf3manifestTb4b4b4.Te6edf3application

Tff7b72?: Te6edf3manifestTb4b4b4.Te6edf3manifestTb4b4b4.Te6edf3primaryEntryTff7b72?.Te6edf3let Tb4b4b4{ Te6edf3found Tff7b72-Tff7b72>

Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3InvalidPackageTb4b4b4(

Ta5d6ff"Ta5d6ffmanifest.json declares no 'application' image (found 'Tffd700${Te6edf3foundTb4b4b4.Te6edf3binFileTffd700}Ta5d6ff'). SoftDevice and Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ffbootloader packages must not be flashed as an application image.Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tff7b72?: Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3InvalidPackageTb4b4b4(Ta5d6ff"Ta5d6ffNo firmware entry found in manifest.jsonTa5d6ff"Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3manifestTb4b4b4.Te6edf3manifestTb4b4b4.Te6edf3imageCount Tff7b72> T79c0ff1Tb4b4b4) Tb4b4b4{

Te6edf3LoggerTb4b4b4.Te6edf3w Tb4b4b4{

Ta5d6ff"Ta5d6ffDFU: package declares Tffd700${Te6edf3manifestTb4b4b4.Te6edf3manifestTb4b4b4.Te6edf3imageCountTffd700}Ta5d6ff images; flashing only the primary Ta5d6ff" Tff7b72+

Ta5d6ff"Ta5d6ff(Tffd700${Te6edf3entryTb4b4b4.Te6edf3binFileTffd700}Ta5d6ff). Combined app+SoftDevice+bootloader packages are not supported.Ta5d6ff"

Tb4b4b4}

Tb4b4b4}

Tff7b72val Te6edf3initPacket Tff7b72=

Te6edf3entriesTff7b72[Te6edf3entryTb4b4b4.Te6edf3datFileTff7b72] Tff7b72?: Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3InvalidPackageTb4b4b4(Ta5d6ff"Ta5d6ffInit packet 'Tffd700${Te6edf3entryTb4b4b4.Te6edf3datFileTffd700}Ta5d6ff' not found in zipTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3firmware Tff7b72=

Te6edf3entriesTff7b72[Te6edf3entryTb4b4b4.Te6edf3binFileTff7b72] Tff7b72?: Tff7b72throw Te6edf3DfuExceptionTb4b4b4.Te6edf3InvalidPackageTb4b4b4(Ta5d6ff"Ta5d6ffFirmware 'Tffd700${Te6edf3entryTb4b4b4.Te6edf3binFileTffd700}Ta5d6ff' not found in zipTa5d6ff"Tb4b4b4)

Te6edf3LoggerTb4b4b4.Te6edf3i Tb4b4b4{ Ta5d6ff"Ta5d6ffDFU: Extracted zip — init packet Tffd700${Te6edf3initPacketTb4b4b4.Te6edf3sizeTffd700}Ta5d6ffB, firmware Tffd700${Te6edf3firmwareTb4b4b4.Te6edf3sizeTffd700}Ta5d6ffBTa5d6ff" Tb4b4b4}

Tff7b72return Te6edf3DfuZipPackageTb4b4b4(Te6edf3initPacket Tff7b72= Te6edf3initPacketTb4b4b4, Te6edf3firmware Tff7b72= Te6edf3firmwareTb4b4b4)

Tb4b4b4}